Tin bất thường dòng tiền

Mô tả API

Lấy bản ghi tin nhắn giám sát biến động vốn chủ lực trên sàn giao dịch tập trung, giao dịch Spot hoặc Hợp đồng của token chỉ định.

Tình huống sử dụng:

• Truy vấn tin nhắn trong quá trình theo dõi thời gian thực của AI đối với token trong danh sách giám sát biến động vốn
• Xem lịch sử bản ghi tín hiệu biến động vốn, bao gồm nhưng không giới hạn biến động ngắn hạn/xu hướng, Alpha, FOMO, chốt lời, cắt lỗ, v.v.

Gợi ý sử dụng:

• Loại tín hiệu cần hiển thị tên; khi có nhiều tin nhắn alpha, fomo, v.v., thống kê số lần xuất hiện của từng loại; khi xuất hiện đồng thời cần nhắc nhở đặc biệt
• Sau khi truy vấn tự nhiên token biến động, hoặc truy vấn tín hiệu biến động, gọi API này
• Dùng kết hợp với API danh sách token biến động vốn; chỉ truy vấn tín hiệu token trong danh sách token biến động vốn mới gọi API này

Tần suất cập nhật dữ liệu: mỗi 5 phút

URL yêu cầu

• Phương thức: POST
• Đường dẫn: /open/v1/ai/getFundsCoinMessageList

Tiêu hao điểm tích lũy

• Điểm tích lũy mỗi lần gọi: 5

Điều kiện tiên quyết

Lấy vsTokenId

Điều kiện	Mô tả	Cách lấy
Đã có vsTokenId	Dùng trực tiếp vsTokenId đã cache, không cần truy vấn lại	Tự động lấy từ ngữ cảnh
Chưa có vsTokenId	Gọi API POST /vs-token/list	Gọi API tiên quyết

Tham số yêu cầu

Truyền tham số trong body dưới dạng JSON.

Tên tham số	Kiểu	Bắt buộc	Mô tả
vsTokenId	long	Có	Token ID
tradeType	integer	Có	Loại giao dịch (1: Spot, 2: Hợp đồng)

Giải thích giá trị enum

tradeType - Loại giao dịch

Giá trị	Ý nghĩa
1	Spot
2	Hợp đồng

Trường phản hồi

Chỉ liệt kê cấu trúc trường trong từng phần tử của mảng data:

Trường	Kiểu	Kiểu thực tế trả về	Mô tả
updateTime	long	long	Thời gian cập nhật (timestamp mili giây)
vsTokenId	long	string	Token ID
symbol	string	string	Ký hiệu token
name	string	string	Tên
tradeType	integer	integer	Loại token (1: Spot; 2: Hợp đồng; 3: Hợp đồng giao hàng)
price	number	string	Giá token
percentChange24h	number	number	Mức tăng/giảm 24 giờ
fundsMovementType	integer	integer	Loại biến động vốn

Ý nghĩa nghiệp vụ

Trường	Ý nghĩa	Gợi ý sử dụng
fundsMovementType	Loại biến động vốn	Xác định loại biến động vốn, như biến động thị trường ngắn hạn, biến động thị trường xu hướng, Alpha, v.v.; khi có nhiều loại cùng lúc có thể nhắc nhở đặc biệt, không hiển thị ánh xạ loại tín hiệu

Ví dụ yêu cầu

{
    "vsTokenId": 22974,      // Token ID
    "tradeType": 1           // Loại giao dịch (1: Spot, 2: Hợp đồng)
}

Ví dụ cURL (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/ai/getFundsCoinMessageList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 22974,
    "tradeType": 1
}'

Ví dụ cURL (Windows CMD)

curl --location --request POST "http://${host}/api/open/v1/ai/getFundsCoinMessageList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 22974,    \"tradeType\": 1}"

Ví dụ phản hồi thành công

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "updateTime": 1773395700000,       // Thời gian cập nhật
            "vsTokenId": "22974",                // Token ID
            "symbol": "TAO",                      // Ký hiệu token
            "name": "Bittensor",                  // Tên
            "tradeType": 1,                       // Loại token (1: Spot; 2: Hợp đồng; 3: Hợp đồng giao hàng)
            "price": "241.4",                     // Giá token
            "percentChange24h": 15.36477852,      // Mức tăng/giảm 24 giờ
            "fundsMovementType": 6                // Loại biến động vốn (6: mức tăng)
        },
        {
            "updateTime": 1773395400000,
            "vsTokenId": "22974",
            "symbol": "TAO",
            "name": "Bittensor",
            "tradeType": 2,
            "price": "240.2",
            "percentChange24h": 4.56494468,
            "fundsMovementType": 3
        },
        {
            "updateTime": 1773395400000,
            "vsTokenId": "22974",
            "symbol": "TAO",
            "name": "Bittensor",
            "tradeType": 2,
            "price": "240.2",
            "percentChange24h": 15.6226012,
            "fundsMovementType": 1
        }
        // ... bỏ qua thêm dữ liệu
    ],
    "requestId": "xxx-xxx-xxx"
}